home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-wnils-whois-lookup-00.txt < prev    next >
Text File  |  1993-07-08  |  12KB  |  349 lines
  1.  
  2. WNILS Working Group                     Joan Gargano
  3. Internet Draft                                          Ken Weiss    
  4. July 1, 1993              University of California, Davis
  5.  
  6.  
  7.              Whois and Network Information Lookup Service
  8.                                 Whois++
  9.  
  10.  
  11. Status Of This Memo
  12.  
  13. This Internet Draft proposes changes to the NICNAME/WHOIS protocol 
  14. described in RFC 954.  Distribution of this memo is unlimited.
  15.  
  16.    This document is an Internet Draft.  Internet Drafts are working 
  17.    documents of the Internet Engineering Task Force (IETF), its Areas, 
  18.    and its Working Groups.  Note that other groups may also distribute 
  19.    working documents as Internet Drafts.
  20.    
  21.    Internet Drafts are draft documents valid for a maximum of six 
  22.    months.  Internet Drafts may be updated, replaced, or obsoleted by 
  23.    other documents at any time.  It is not appropriate to use Internet 
  24.    Drafts as reference material or to cite them other than as a "working 
  25.    draft" or "work in progress." Please check the 1id-abstracts.txt
  26.    listing contained in the internet-drafts Shadow Directories on
  27.    nic.ddn.mil, nnsc.nsf.net, nic.nordu.net, ftp.nisc.sri.com, or
  28.    munnari.oz.au to learn the current status of any Internet Draft.
  29.  
  30. This Internet Draft expires December 31, 1993.
  31.  
  32. I.    Introduction
  33.  
  34. As currently defined, NICNAME/WHOIS service is a TCP transaction based 
  35. query/response server, running on a few specific central machines, that 
  36. provides netwide directory service to Internet users.  The Network 
  37. Information Center (NIC) maintains the central NICNAME database and 
  38. server, defined in RFC 954, providing online look-up of individuals,
  39. network organizations, key host machines, and other information of
  40. interest to users of the Internet.  The usefulness of this service has
  41. lead to the development of other distributed directory information
  42. servers and information retrieval tools and it is anticipated more will
  43. be created.  Many sites now maintain local directory  servers with
  44. information about individuals, departments and services at that specific
  45. site. 
  46.  
  47. Typically these directory servers are network accessible.  Local
  48. development of these services has resulted in wide variations in the
  49. type of data stored, access methods, search  schemes, and user interfaces.
  50. The purpose of the Whois and Network Information Lookup Service Working
  51. Group  (WNILS) is to expand and define the standard for WHOIS types of
  52. services, to resolve issues associated with the variations in access and
  53. provide a consistent and predictable service across the network.  This
  54. Internet Draft describes new features for WHOIS to meet these goals.
  55.  
  56.  
  57.                                   1
  58.  
  59.  
  60. WNILS Working Group      Whois++ Lookup Service   Gargano, Weiss
  61.  
  62.  
  63. II.    Architecture
  64.  
  65. The WHOIS service should be provided in a client/server model.  There are 
  66. no restrictions on the  design of the client, provided it is capable of
  67. passing queries to the server in the proper format, and capturing the
  68. server's response in some useful format.  Existing WHOIS specifications
  69. call for clients to display responses in human-readable form.  This more
  70. general proposal does not impose that restriction.
  71.  
  72. This paper acknowledges the existence of many distributed information 
  73. servers, and anticipates the creation of many more. To help users locate 
  74. WHOIS servers, each server should have a nameserver entry in the form 
  75. "whois.domain", i.e. whois.internic.net.
  76.  
  77.  
  78. III.    Client Design and Behavior
  79.  
  80. The client provides the user interface to the WHOIS system and a 
  81. mechanism for query generation and display of the response.  The client
  82. is responsible for providing support for paging of long output from the
  83. server.  All clients must provide this service.  The server will not
  84. include any special characters, or make any efforts to control output to
  85. a screen.
  86.  
  87. Special search criteria may be specified by the use of keywords or
  88. special characters, some of which are defined in RFC 954.  Clients
  89. should be designed to make support for quoted strings unnecessary.
  90.  
  91.  
  92. IV.    Server Design and Behavior
  93.  
  94. The server should return the same information in response to a given
  95. query consistently, regardless of the client software or the hardware
  96. used to originate the query. Queries should be evaluated on a
  97. case-insensitive basis. Spaces should not be considered in searches.
  98. A search for "La Russo" should return both "LaRusso" and "La Russo" as
  99. matches.
  100.  
  101. There are three types of data records supported in this proposal:
  102. records for people, hosts, and domains.
  103.  
  104. Individual records
  105.  
  106. Name            Name of the individual         required
  107.         
  108. Organization         Name of the organization     required
  109.         
  110. Organization-type     Type of organization         optional
  111.              (university, commercial,
  112.             research)
  113.     
  114. Work-telephone         Work telephone number         optional
  115.  
  116.  
  117.                                  2
  118.  
  119. WNILS Working Group      Whois++ Lookup Service   Gargano, Weiss
  120.  
  121.  
  122.         
  123. Fax-telephone         Fax telephone number         optional
  124.         
  125. Work-address         Work postal address         optional
  126.             
  127. Title             Working title or position     optional
  128.              within an organization
  129.     
  130. Department         Department                 optional
  131.         
  132. Email-address         Email address in RFC 822      optional
  133.              format for this individual
  134.     
  135. Handle             A unique identifier for this      required
  136.              record on the local server
  137.     
  138. Last-update         Date this record was last      required
  139.             updated
  140.         
  141. Home-telephone         Home telephone number         optional
  142.         
  143. Home-address         Home postal address         optional
  144.  
  145.  
  146. Host records
  147. Domain records
  148.  
  149. Domain-name    Domain name registered with the     required
  150.         Network Information Center (NIC)
  151.     
  152. Network-address Network address associated with this     required
  153.         domain name
  154.     
  155. Admin-name     Name of the Administrative Contact for     required
  156.         this domain
  157.     
  158. Admin-address     Postal address of the Administrative     required
  159.         Contact for this domain
  160.         
  161. Admin-telephone Telephone number of the Administrative     required
  162.         Contact for this domain
  163.     
  164. Admin-email     Electronic mail address in RFC 822     required
  165.         format for the Administrative Contact 
  166.         for this domain
  167.  
  168. Tech-name     Name of the Technical Contact for this     required
  169.          domain
  170.     
  171. Tech-address     Postal address of the Administrative     required
  172.         Contact for this domain
  173.     
  174.         
  175.                                   3
  176.  
  177. WNILS Working Group      Whois++ Lookup Service   Gargano, Weiss
  178.  
  179.  
  180. Tech-telephone     Telephone number of the Technical     required
  181.         Contact for this domain
  182.     
  183. Tech-email     Electronic mail address in RFC 822     required
  184.         format for the Administrative Contact 
  185.         for this domain
  186.  
  187. Nameservers     Primary domain nameservers for this     optional
  188.         domain
  189.     
  190. Last-update     Last date this record was updated    required
  191.  
  192.  
  193. Search Options
  194.  
  195. A unique handle must be provided for every record in the serve
  196. database to target specific records for display.  For example, if
  197. there are three individuals named, respectively, A. La  Russo,
  198. B. LaRusso, and C. Larusso, then a search for "LA RUSSO" would return
  199. all three as matches.  However, each record would have a unique handle,
  200. i.e. LARUSSO1, LARUSSO2, and LARUSSO3. A search for any one of these
  201. handles would return a single match for that particular individual.
  202. This is consistent with the RFC 954 query, "whois !SMITH1"
  203.  
  204. Other search options which should be supported are:
  205.  
  206. whois smith         exact match on last name
  207.     
  208. whois smith,j         exact match on last name, first name 
  209. whois "smith,j"     begins with "J"
  210. whois j. Smith    
  211. whois "j. Smith"    
  212.     
  213. whois smith, john     exact match on last and  first names
  214. whois "smith, john"    
  215. whois john Smith    
  216. whois "john Smith"    
  217. whois .john Smith    
  218.     
  219. whois "smith..."     all last names beginning 
  220. whois smith*        with Smith
  221. whois begins smith    
  222.     
  223. whois smith??         all last names beginning with
  224.             "Smith" and containing up to two
  225.             letters after "Smith",  i.e. "Smith",
  226.             "Smithy", "Smithey" and "Smithie"
  227.     
  228. whois ends smith     all last names ending in "smith"
  229.     
  230. whois exact A Martinez     exact match for "A Martinez"
  231.     
  232.  
  233.                                 4
  234.  
  235. WNILS Working Group      Whois++ Lookup Service   Gargano, Weiss
  236.  
  237.  
  238. whois fuzzy paulson     all last names that sound like or
  239.             are spelled like "Paulson"
  240.     
  241. whois first Kazuko     exact match on first name "Kazuko"
  242.     
  243. whois first begins Art    all first names beginning with "Art"
  244.     
  245. whois first fuzzy Kasuko     all first names that sound like or
  246.                 are spelled like "Kasuko"
  247.     
  248. whois hamlet.ucdavis.edu     IP address and other information
  249. whois system hamlet.ucdavis.edu    on the computer called
  250.                 hamlet.ucdavis.edu.Could be served
  251.                 by a domain name service querytype
  252.                 (QTYPE) *
  253.       
  254. whois system hamlet     IP address and other 
  255.              information on the computer called
  256.             hamlet with the default domain
  257.             appended.  Could be served by a
  258.             domain name service  querytype
  259.             (QTYPE) *
  260.     
  261. whois 128.120.2.9         domain name and other 
  262. whois system 128.120.2.9     information on the computer at
  263.                 specified IP address.  Could be served
  264.                 by a domain name service querytype
  265.                 (QTYPE) PTR.
  266.     
  267. whois !ucdavis-dom         site contacts and other 
  268. whois domain ucdavis.edu     information  on the site ucdavis
  269.  
  270. If any keywords are specified in the query, the server will complete
  271. that specific query and return the results (even if 0 matches are
  272. found).  If no keywords are specified, the server will interpret the
  273. query based upon the rules above. Optionally, the server may be
  274. configured so that if a search yields no matches, the query will
  275. automatically be run again, but with the keyword begin inserted.
  276.  
  277. Servers must support multiple levels of detail in response to queries.
  278. A query yielding multiple matches should return a short-form record
  279. for each match. A query yielding a single match should return a
  280. long-form record. A query yielding no matches should return
  281. context-sensitive help on expanding the search criteria.
  282.  
  283.  
  284. On-line Help
  285.  
  286. The client should return a minimal (two line) help message for every
  287. query sent to the server. That message should identify the database
  288. being searched and provide instructions for the user to obtain more
  289. detailed help screens.
  290.  
  291.                                 5
  292.  
  293. WNILS Working Group      Whois++ Lookup Service    Gargano, Weiss
  294.  
  295.  
  296. Additional help should be provided in special situations. The server
  297. should recognize queries that return zero matches, and provide a brief
  298. help message explaining how to broaden a search.  If a search returns
  299. more than 50 matches, the server should take two actions.  First, the
  300. user should get a message explaining how to narrow searches.  Second,
  301. the user should be offered the option of re-specifying the search, or
  302. receiving all matching responses.  When multiple matches are found and
  303. returned to the client, the server should add a brief help message
  304. explaining how to use handles to narrow the search to a single record.
  305.  
  306. If the client queries for "help" or "?" then the server should return
  307. a complete help file.  The help file should contain information in
  308. sufficient detail for the user to understand and access all the features
  309. of WHOIS service.
  310.  
  311.  
  312. V.    Extensibility
  313.  
  314. This Internet Draft defines a limited set of data records and fields
  315. for reliable whois queries.   Mechanisms exist, Deutsch, et. al. August
  316. 1992, for whois clients to discover extended data records and query for
  317. fields not defined in this draft.  It is recommended that Whois clients
  318. and servers include this functionality to maximize the extensibility and
  319. usefulness of this service. 
  320.  
  321.  
  322. VI.    References
  323.  
  324. Deutsch, et al. Architecture of the WHOIS++ service. August 1992. 
  325. Available by anonymous FTP as 
  326. ftp.ucdavis.edu://pub/archive/wnils/Architecture.Overview
  327.  
  328. VII.    Authors Addresses
  329.  
  330. Joan Gargano
  331. Information Technology
  332. Distributed Computing Analysis and Support
  333. University of California
  334. Davis, CA   95616
  335. jcgargano@ucdavis.edu
  336.  
  337. Ken Weiss
  338. Information Technology
  339. Distributed Computing Analysis and Support
  340. University of California
  341. Davis, CA   95616
  342. krweiss@ucdavis.edu
  343.  
  344.  
  345. This Internet Draft expires December 31, 1993.
  346.  
  347.  
  348.                                    6
  349.